home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / utime.0 < prev    next >
Text File  |  1996-09-02  |  4KB  |  89 lines
  1.  
  2. UTIME(3)                   UNIX Programmer's Manual                   UTIME(3)
  3.  
  4. NNAAMMEE
  5.      uuttiimmee - set file times
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
  9.      ##iinncclluuddee <<uuttiimmee..hh>>
  10.  
  11.      _i_n_t
  12.      uuttiimmee(_c_o_n_s_t _c_h_a_r _*_f_i_l_e, _c_o_n_s_t _s_t_r_u_c_t _u_t_i_m_b_u_f _*_t_i_m_e_p)
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy uuttiimmeess((22)) ..
  16.  
  17.      The uuttiimmee() function sets the access and modification times of the named
  18.      file.
  19.  
  20.      If _t_i_m_e_p is NULL, the access and modification times are set to the cur-
  21.      rent time.  The calling process must be the owner of the file or have
  22.      permission to write the file.
  23.  
  24.      If _t_i_m_e_p is non-NULL, _t_i_m_e is assumed to be a pointer to a utimbuf struc-
  25.      ture, as defined in <_u_t_i_m_e_._h>:
  26.  
  27.            struct utimbuf {
  28.                    time_t actime;          /* Access time */
  29.                    time_t modtime;         /* Modification time */
  30.            } ;
  31.  
  32.      The access time is set to the value of the actime member, and the modifi-
  33.      cation time is set to the value of the modtime member.  The times are
  34.      measured in seconds since 0 hours, 0 minutes, 0 seconds, January 1, 1970,
  35.      Coordinated Universal Time.  The calling process must be the owner of the
  36.      file or be the super-user.
  37.  
  38.      In either case, the inode-change-time of the file is set to the current
  39.      time.
  40.  
  41. RREETTUURRNN VVAALLUUEESS
  42.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  43.      of -1 is returned and _e_r_r_n_o is set to indicate the error.
  44.  
  45. EERRRROORRSS
  46.      UUttiimmee() will fail if:
  47.  
  48.      [EACCES]      Search permission is denied for a component of the path
  49.                    prefix; or the _t_i_m_e_s argument is NULL and the effective us-
  50.                    er ID of the process does not match the owner of the file,
  51.                    and is not the super-user, and write access is denied.
  52.  
  53.      [EFAULT]      File or _t_i_m_e_s points outside the process's allocated ad-
  54.                    dress space.
  55.  
  56.      [EINVAL]      The pathname contains a character with the high-order bit
  57.                    set.
  58.  
  59.      [EIO]         An I/O error occurred while reading or writing the affected
  60.                    inode.
  61.  
  62.      [ELOOP]       Too many symbolic links were encountered in translating the
  63.                    pathname.
  64.  
  65.      [ENAMETOOLONG]
  66.                    A component of a pathname exceeded 255 characters, or an
  67.                    entire path name exceeded 1023 characters.
  68.  
  69.      [ENOENT]      The named file does not exist.
  70.  
  71.      [ENOTDIR]     A component of the path prefix is not a directory.
  72.  
  73.      [EPERM]       The _t_i_m_e_s argument is not NULL and the calling process's
  74.                    effective user ID does not match the owner of the file and
  75.                    is not the super-user.
  76.  
  77.      [EROFS]       The file system containing the file is mounted read-only.
  78.  
  79. SSEEEE AALLSSOO
  80.      stat(2),  utimes(2)
  81.  
  82. HHIISSTTOORRYY
  83.      A uuttiimmee() function appeared in Version 7 AT&T UNIX.
  84.  
  85. SSTTAANNDDAARRDDSS
  86.      The uuttiimmee() function conforms to IEEE Std1003.1-1988 (``POSIX'').
  87.  
  88. 4th Berkeley Distribution       August 13, 1993                              2
  89.